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SECTION 1 —- THE M.C.L. CONCEPT 


-FAIRLIGHT M.C.L. (MUSIC COMPOSITION LANGUAGE)- 


SECTION 1 - THE M.C.L. CONCEPT 


1.8 STRUCTURE 


M.C.L. is a TREE-STRUCTURED language. This means that a 
composition is treated as a tree containing three levels of 
hierarchy. These levels are called PIECE, PART and SEQUENCE. The 
tree structure means that a PIECE consists of one to eight PARTS 
to be played simultaneously, and each PART consists of one or more 
SEQUENCES which are played sequentially. 

Although a maximum of eight parts can be played at once, the 
PIECE can contain a ninth PART as well. This PART can be used for 
programming control information, i.e. for varying the Page 7 
controls and switches under M.C.L. control. 

Sequences may be of any length from 1 to 20@@ notes, although 
there is of course a limit to the total number of notes of 
Sequence that can be accommodated at once. Note that more than one 
PART may share one or more common SEQUENCES. The one SEQUENCE can 
be played by several Parts simultaneously without any interaction 
between them. 

a, it is convenient to think of each PART asa different 
musician’; each “musician plays a series of SEQUENCES on his own 
keyboard. ; 

The playing of each PART is independent of other PARTS which 
may be playing at the same time. 

The PIECE behaves like a “conductor, instructing which PARTS 
are required to play and when they are to start. 

Chords are permitted in SEQUENCES as long as the notes of the 
chord are all of the same duration and sufficient NPHONY has been 
allocated on page 3. 

The PARTS may call for any number of sequences, with the 
restriction that a maximum of 32 files may be resident in the. 
system at the same time, irrespective of their size. 

PARTS may also specify which conceptual keyboard is to be played 
by that PART, allowing switching from one register of the 
Fairlight to another between sequences. 
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SECTION 1 - THE M.C.L. CONCEPT (CONTINUED ) 


TREE STRUCTURE OF M.C.L. 


me ee ae ee ee 


PIECE 
PARTI PART2 PARTS PART4 PARTS ... maximum 9 parts 


TA 


SEQUENCE1 SEQUENCE2 SEQUENCES SEQUENCE4 SEQUENCES SECUENCEE... 


SECTION 1 - THE M.C.L. CONCEPT (CONTINUED ) 


1.1 CAPACITY 


Due to the enormous number of different possibilities 
availatle to the musician using M.C.L., it is meaningless to try 
to specify performance figures such as the Maximum length of 
Pieces possible or the number of keystrokes required to define a 
given amount of music . The answer to most such questions will 
generally be that depends... . Suffice it to say that under WORST 
CASE conditions, that is without using any of the tree structure 
or cther short-cuts, several minutes of complex polyphonic music 
can te held in the fFairlight’s main memory. Using the full 
facilities it is a Simple matter to specify hundreds of hours of 
music with just a few minutes typing. 


1.2 ACCURACY 


The time resolution of M.C.L. playing software is about 1 
millisecond, so that very precise control of relative timing of 
events is possible. For example,-rests of 1/192 of a beat can be 
used to generate subtle timing offsets to overcome the 

mechanical sound of a mathematically perfect performance. In 
fact, the timing control is sufficiently fine to achieve 


"flanging” effects by playing two identical voices slightly out of 
step. 


1.3 SYNCHRONISATION 


The Fairlight can accept an external SYNC input from which 
the M.C.L. replay system derives its timing reference. This can be 
used to synchronise to multi-track tape, motion-picture frames or 
any other source of pulses. By laying down a pilot track on tape 
before recording multi-part works, overall tempo variations common 
to all subseauent recording passes can easily te achieved. 

It is also possible to synchronise a piece with any external 
event by use of the W function, which makes the M.C.L. halt at a 
precetermine@ place in the music until a key on the alphanumeric 
keyboard is struck. 
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SECTICN 1 - THE M.C.L. CONCEPT (CONTINUED) 


1.4 PRINCIPLE OF OPERATION 


The M.C.L. system is supplied as part of a special Fairlight 

System Disk. The middle two digits of the version number displayed 
on Page 1 will be C followed by the version of M.C.L. on that 
disk. 
Like the page ¢ sequencer, the M.C.L. system plays music via 
Keyboards 1 to 8 on Page 3 of the Fairlight. After the required 
selection of veices and register allocations have been made on 
Page 3, the M.C.L. system is entered by typing PC <RIND> on any 
display page. The system will restond with the M.C-L. sign-on 
message, followed by the M.C.L. prompt. The prompt is the > 
symbol, and when it appears at the bottom left of the Screen, it 
indicates that the M.C.L. is ready to accept a command. 

Various commands are available for creating, editing, saving, 
loading and playing M.C.L. files. They are described in detail in 
section 2. Certain commands may result in a delay of a few seconds 
before they start execution, if requested immediately after page C 
is entered. 

To enter a new composition, the M.C.L. Editor is used to 
create a Sequence File. This is done using the “NEW” command 
(described in section 3) to create the new file. The EDITOR 
commands (see section 5) are then used to enter the notes, 
durations and other musical data to create the Sequence file. 

The data entered is not validated at this stage, that is you 
do rot find out about errors until the M.C.L. tries to play what 
you have specified. When all the data for the sequence has been 
entered, the Edit is ended by typing Exesc>. The text disappears 
from the screen and the M.C.L. prompt appears again. 

The sequence can then be Blayed immediately using the PLAY 
command (see section Z). Any errors will be detected at run-time 
(i.e. as the M.C.L. tries to play what has been entered). 

Invalid information in the sequence file will cause a WARNING 
message cr an ERROR message to be displayed. A WARNING results 
when certain limits ére exceeded, but the music goes on 
regardless. An ERROR results from feeding the M.C.L. data which 
it cannot understand at all, in which case it stops playing. Both 
types of message will display the offending line with an arrow 
pointing to the problem. 

Further sesuences can be entered in this way and played 
individually. Which sequence is played is determined by the 
secuence file-name which is entered as part of the PLAY command. 
™o make a number of seavence file play one after the Other, their 
names are entered into a PART file (see section 2), then the 
M.C.L. is instructed to play that Part. To play a number of 
secuences simultaneously, their names are entered into a PIECE 
file (see section 2) and the PIECE file is played. 

The various files created are NOT automatically saved on 
disc. They are saved using the SAVE command (section 3) for later 
recall and editing. 


SECTION 26 .Cubs FILES 


SECTION 2 M.C.L. FILES 
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2.@ FILE STRUCTURE 


When creating or editing an M.C.L. file, line numbers are 
automatically inserted for the convenience of the musician. They 
are ignored by the system. Line numbering is useful for locating a 
particular point on a score if reference numbers are written down 
as the music is typed in. Run-time error messages print the line 
of text causing the error, with the line number of the offending 
line. 

Comment lines may be included in any file. These must have an 
* in the first non-blank character position following the line 
num ter. Comments are for the musician’s reference only and are 
igno red by the M.C.L. By placing an * at the beggining of any 
line of music, that line is turned into a comment and will 
therefore not be played. 

All files must be terminated by an END statement. The ‘END 
statement must be in a line of its own. Its purpose is to tell the 
M.C.L. that the end of the current-file has been reached. Any text 
after the END statement will be ignored. Note that for obvious 
reasons, END may not be used as a filename. 

Three different types of file are used by M.C.L. These are 
PIECE, PART and SEQUENCE files. 

Extensive use is made cf the concept of DEFAULTS. This is a 
time-saving technique whereby it is not necessary to specify every 
Parameter controlling each event explicitly. For example, if a 
whole series of notes are to be played in the same octave, it is 
pessible to set a DEFAULT octave which the M.C.L. will use 
whenever an octave number is not stated. 


2.1 FILE MANAGEMENT 


Composer file management is performed by the Fairlight, PAGE 2 
system. Fy requesting P2 and entering the command M+ , the 
displayed files will be those with .SS, .PT, and .PC suffixes. It 
is then possible to change the name of a file, delete a file or 
back up a file in the same way as normal Fairlight files. 
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SECTION 2 M.C.L. FILES (CONTINUED) 


2.2 SEQUENCE FILES: sequencefile.SS 


Sequence files are a list of the items to be played. These 
include default settings, note specifications, repeat directives, 
control parameter changes, relative operations and comments. 

The first non-tlank character of each line in a sequence file has 
a special meaning: 


* for comment lines (ignored) 
! for default specification 


Anything else means a line of music. 
The following parameters may be specified as defaults: 


2.2.4 TEFAULTS 


EBFAT- number of sub-divisions within each time unit, e.g. !B=16 
means use default of 16 subdivisions per beat. 


GAP- specifies the time between the end of the current note and 
the start of the next note.-It is calculated in BEAT units. 
The GAP time must obviously not excede the nctes time value, 
and it must also be greater than zero. 
1G=1/4 means the conceptual key-release occurs 1/4 of a 
value before the next note starts. 


B 


HOLI- used as an alternative to GAP, specifies the duration (in B 
units) .of the conceptual key depression . HOLD time must be 
greater than zero and less than the note duration. 


OCTAVE- specifies in which keyboard octave the specified note 
falls. 
!10=2 means unless otherwise specified, notes are in octave 2. 
of the keyboard. 


TRANSPOSITION- adds an offset to the note requested. It is 
specified as the number of keys up or down the keyboard the 
note is to be moved. 

!1T=2 means play the note 2 keys (half tones) up the keyboard 
from where the specified note actually is. Transposition may 
be positive or negative. 


VELOCITY- specify the effective “key velocity” used when playing a 
note. The key velocity data is used exactly as if it had 
originated from the music keyboard, it’s precise effect being 
determined by PAGE 7 allocations. Velocity data must be in the 
range € to 15. 1!V¥=15 is the fastest velocity. 
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SECTION 2 M.C.L. FILES (CONTINUED) 


KEY SELECTION- allows defaulting certain notes to be assumed sharp 
or flat to achieve a certain key signature. <cntrl s>, <cntrl 
f> and <cntrl d> are used on the alphanumeric keyboard to 
specify sharp, flat or natural respectively. !<contrl SOF 
selects F to be sharp unless ctherwise directed. 

For example: 


Icntrl s>F:<cntrl s>C:<cntrl s>G sets key of A maj. 


Several different default parameters may be specified within 
line by separating them with colons, e.g. 
1C=Z:B=8:G=3/8:<cntrl f>B 


one 
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SECTION 2 M.C.L. FILES (CONTINUED) 


2.2.1 NOTE SPECIFICATION 
Fach note may be fully specified by: 


pitch [velocity],[([time],(gap or hold] 


(Items shown in Square brackets are optional; defaults apply if 
not supplied) 


PITCH- The name of the note, A,B,C,D,E,F or G. It may optionally 

be preceded or followed by an accidental sharp, flat or 
natural which will override ary key signature default 
currently in force. 
The octave number may be specified immediately following the 
note (and accidental, if there is one). The octave number may 
be specified as relative to the default octave by using a + or 
- Sign followed by the numter of octaves above or below the 
default octave. E.zg: A+2 means A two octaves above the 
default, so if an 0=3 default had been set previously, the A 
will play in octave 5. 


VELOCITY- The key velocity (as specified on page 7), can be 
changed for this note only. AVY6 means to play note A with a 
key ‘velocity of 6. (range: @ to 15). Like the octave 
selection, a relative key velocity can be specified, e.g. AV+5 
means use the default key velocity value plus 5 for this note. 


TIME- The total time for this ncte (i.e. the time to the start of 
the next note rather than the time to the key release).It is 
expressed as a number of BEAT units, the absolute value of 
which will be determined by the SPEED selected. The TIME may 
te an integer or a fraction, and may be greater than one. The 
TIME value will be multiplied ty the BEAT value to give the 
time to the next note, soit is important to ensure that the 
BEAT value and TIME are selected so that exact arithmetic is 
possible, e.g: 

B=24 works with A,3/4 but with A,3/5 specified rounding errors 
would result in timing inaccuracies. 


GAP- Time (in B units) dDetween the conceptual “key release” and 
the start of the next note. 


HOLI- may be specified instead of GAP time for any note or chord. 
This is the time (in Beats) that the note is to be held on. 
Thus either GAP or HOLD time may be specified for a particular 
note, or else a default value will be used. If a default is 
used then the last default specification will be used to 
determine whether the default gap or default hold time is 
used. Default hold time is specified by E=<number or 
fraction>. To specify a hold time for a particular note or 
chord the comma which normally precedes the GAP time is 
replaced with a fullstop (period). For example: 
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SECTION 2M.C.L. FILES (CONTINUED) 


A,1/2,1/4 ... note time 1/2, gap time 1/4 
Ata fa -e- note time 1/2, hold time 1/4 
(A338), 172.174 --- chord time 1/2, hold time 1/4 


_If there is no note time specified then the comma after the 
note name an be omitted altogether, thus: 


A.1/4 ... note time 1, hold time 1/4 
is the same as A,.1/4 


also (A:B).1/4 --- chord time 1, hold time 1/4 
If default gap is currently in effect and you want to use the 


default hold time then write the fullstop but with no time 
following, thus: 


A,1/2. ... note time 1/2, hold time default 
or his -+. note time 1, hold time default 


Similarly when default hold is in effect, default gap can be 
forced by writing the comma with no time, thus: 


a -.. note time 1, gap time default 


Note that forcing the other default value in the above cases 
will not affect the default value used for following notes. 
The general default is only changed by a G= or H=. The initial 
default assumed at the start of a piece is GAP. 


Fach nete MUST have at least a PITCH specification. All other 
parameters for the note may default if desired. A REST may bde 
implemented by specifying R in the PITCH field (instead of a 
note). Rests may be followed by a time value, but GAP and HOLD 
have no meaning in this case. If it is desired to default the time 
value but not the gap of a note or chord, double commas must de 
used betweer the pitch and the gap, e.g. 


P,2,1/4 play B (may be sharp or flat depending on key selection), 
lasting 2 beats and released after 1 3/4 beats 


B,,1/€ use default time value (i.e. same as B,1,1/8) 
R4 Play B, octave 4 (i.e.override key signature) 


<entrl d>C4 Play C natural, octave 4 


Several rotes may te specified on the one line, seperated dy 
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SECTION 2 M.C.L. FILES (CONTINUED) 
colons, e.g. 


AsBeCsA,1/430,1/4,1/16 


Notes to be played simultaneously (i.e. as chords) are grouped 
together in parentheses: 


(ASE:A2:D2) ,3,1/2. : (A2:D2:D2:C) 
In general, spaces in between note specifications are 


ignored, so that they can be included in the source text to make 
it more readable. 


Appendix A gives examples of a variety of different note 
specification formats. 


2.2.2 REPEATS 


Repeats may be implemented at the sequence level by enclosing 
the section to be repeated in < > followed by the number of times 
the section is to be played. e.g.: 


<AsEB:C>S means the same as AsBsC:A:B:C:A:B:C 


Repeats may be nested up to six levels, e.g: 
<<A:B:C>2 D>2 is the same as A: B:C:A:BsC:D:A:B:C:A:B:C:D 


Fepeats may spread Over more than one line if required, but 
any repeat must te contained wholly within the one Sequence file. 
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SECTION 2 M.C.L. FILES (CONTINUEL) 


2.2.2 RELATIVE SPECIFICATION 


All default values can be dynamically modified by specifying 

a RELATIVE value, that is to add or subtract some given number 
from the current value of the default, or divide or multiply it dy 
some number. The format is similar to setting a default, except 
that a+ or - is Specified after the = to indicate a RELATIVE 
Change, rather than an ABSOLUTE VALUE. For example: 
O=+1 will increment the octave number from whatever value it 
happers to be at that time. The effect of this is cumulative, so 
care is required to keep track of the current values, otherwise 
the permissible limits may be exceeded. If a value does exceed the 
limit, the M.C.L. will generate an errcr message when it attempts 
to play the sequence. Remember that the conventional default 
settings such as C=Z are absolute and will therefore always reset 
the default to the szvecified value. 

It is also permissible to specify a relative ratio (ie 
multiply or divide by a constant). This is written as, for 
example, B=*6 or B=/8, where * represents multiplication and / 
represents division. This method of changing speed enables 
aifferent setuence files to have different B values and still keep 
in Step when a speed change is desired. However the remarks made 
earlier atout ensuring that the numbers are compatible to avoid 
rounding errors also apply here. Thus if the current value of V is 
1@ and the command V=/7 is given then a rounding error will 
result. 


2.2.4 CONTROLS AND SWITCHES 


The PAGE 7 controls and switches can be specified from an MCL 
Sequence by specifying: 


Cn=<number or relative specification> 
and Sn=@ or 1 or OFF or ON 


These may appear anywhere in a seauence file (except on a 


comment line) including a default specification line (preceeded by 
a !). For example: 


! C1=129 : S2=ON : S$3=¢ 
* NOTE THAT C1=120:S2=1:S2=OFF WOULD DO THE SAME 
* CONTROL 1 SET TO 120; SWITCH 2 ON; SWITCH 3 OFF 


C1=/3 : C1=*2 
.* CONTROL 1 IS DIVIDED BY 3 AND MULTIPLIED BY 2, GIVING 80 
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SECTION 2 M.C.L. FILES (CONTINUED) 


The M.C.L. keeps track of control settings for as long as a 
Piece is in progress. The M.C.L. controls and switches will 
override the actual switches, controls and pedals on the music 
keyboard as long as these are not operated at the same time. The 
range of values permitted for controls is 4% to 127. If this range 
is exceeded then the value will be limited, and a warning given 
(if warning messages are enabled). When relative specifications 
are used teer in mind that if more than one sequence references 
the same control then the sequences may interact in an 
unpredictable marner. Controls and switches (along with all other 
sequence file specifications) may te used in part files if the 
line contains a in the first column. 


2.2.5 WAIT FUNCTION 


By inserting the character W into a sequence file the music 
can be synchronised with any external event. If the WAIT function 
is enabled (by WAIT=ON), then when the PLAY command reaches the W, 
the Flaying of music will be suspended until any key on the 
alphanumeric keyboard or music keyboard keypad is struck. 

The key may be struck in advance so that there is no wait at 
all. As soon as the key has been Struck, the music will. then 
resume as if nothing had happened. 
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SECTION 2 M.C.L. FILES (CONTINUED) 


2.2.6 PROMPT 


This feature allows a piece of music being played by M.C.L. 
to give cues to the musician by displaying Pre-programmed messages 
On the music keyboard display, or the graphics screen. It is also 
possible to send data to another computer or synthesizer which can 
be connected to the CMI’s line printer output or parallel 
interface output. The commands for erabling this function and 
determining which output device will be used are described in, 
section 3. 

An output message (or control data) can be inserted in any 
sequence file (or after a ” in the first column of a part file) dy 
enclosing the string of characters in square brackets [ ] (these 
are obtteined by typing shift-K for [ and shift-M for J). The 
String must be entirely on one line of the file. Any printable 
Character may be sent, and by using the special character : 
(colon), any unprintable character may also be sent. The colon 
indicates either a hexadecimal value or a control character 
definition. If the character following the colon is a valid hex 
digit (ie in the range @ to 9 or A to F) then it and'the 
following character are converted to a hexadecimal number. If the 
second character is not a valid hex digit then the prompt string 
will te terminated. The first character after the colon may also 
be one of the fcllowing special control characters: 


R,L,P,N,S,X,H which will cause the corresponding control character 
from the tatle telow to be sent: 


:R will send <carriage return> hex @D 
shi will send <line feed> hex OA 
:P will send <form feed> hex 8C 
3H will send <null> hex @@ 
:s will send <escape> hex 1B 
:X will send <backspace> hex 88 
2H will send <cancel> hex 18 


In these cases only the first character after the colon is 
treated as a special character. It is not necessary to use any of 
these control characters when sending messages to the music 
keytoard display. The other special character, " (doudle quote), 
forces the following character to be transmitted exactly as is. 
Thus to send a colon use =: to send a right square bracket use J 
and to serd a double auote use ° EXAMPLES : 


[ABCLEFG] sends ABCDEFG 
[AEBCDEFG:R:L] sends ABCDEFG<cr><lf> 


[:7F J 72°" saa] sends <rubout>]:"<linefeed> 


The timing is arranged so that the transmission of the string 
will begin at exactly the time specified in the sequence file 
(provided that the output device is ready), and will continue as a 
background task to the playing of music. Thus the time taken to 
output the string will not affect the timing of the music in any 
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way. If a second literal output request is encountered before the 
previous cne is completed then the first one will be truncated and 
the next one will start immediately. 
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2.3 PAPT FILE: partfilename.PT 


PART files are a list of SEQUENCE FILES to be played 
sequentially by that PART. Keyboard number played may also de set 
here, using JkX=n as a line in the file. In the following example 
the sequences SEC1 and SEQ2 will be played on keyboard #1 and 
sequences SEQS and onwards will be keyboard #2. 


It is also possible to insert lines of SEQUENCE file information 
(i.e. notes, rests, chords and default information) into apart 
file ty placing a double «uote character (") in the first position 
in the line. Whatever follows this character will be treated 
exactly as though it was within a sequence file. Thus, if it is 
necessery for a PART to play a SEQUENCE, then wait a while before 


playing the next SEQUENCE, the reauired number of rests can be 
inserted in the PART file. 


PART files are of the form: 


* This is a comment. 

* START PLAYING KEYBOARD #1 

1K=1 

SECLSSS 

SFOQ2.SS 

* NOW SWITCH TO KEYROARD #2 

{K=2 

SFQ3.SS 

* WAIT FOR 4 EEATS, THEN PLAY SEQ1.SS AGAIN 
* 


* TER DOUBLE QUOTE WILL MAKE THE FOLLOWING LINE INTO A SEQUENCE 
R,4 
SEQ1 


END 


Note that as only SEQUENCE names may appear in PART files, the .SS 
suffix is redundant and therefore optional. 
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2.4 PIECE FILE: plecefilename.PC 


PIECE files are a list of PARTS which are to be played 
Simultaneously. The order in which the PART files are specified 
determines the keyboard number that part will play unless an 
over-riding IK= statement is uSed in the PART file. In the 


following example, PARTA will play keyboard #1, PARTB will play 
keyboard #2 etc. 


PIECE files are of the form: 


* This is a comment. 
PARTA.PT 

PARTB 

PARTC 

SEFO1.5S 


END 


In general PIECE files will contain only PART files, so the 
-PT suffix on filenames is optional and may be omitted. However 
PIECE files may contain SEQUENCE filenames provided that the 
suffix .SS is explicitly stated. 
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SECTION ¢ -— M.C.L. COMMANDS 


A number of commands are available for selecting various 
M.C.L. functions such as editing, loading, saving or playing 
files. Commands may only be entered when the prompt > is displayed 
On the screen. This means that a command can not be entered while 
a PLAY is in pregress, which must be terminated with <cntrl ESC), 
or an EDIT is is progress , which must be terminated be <E ESC>. 

Some commands require a filename to specify which file is to 
be acted upon. A default system is provided in some cases, whereby 
if no filename is specified the name last used will be assumed. 

Certain commands may result in a delay of a few seconds 
be?ore they start execution if requested immediately after page C 
is entered. 

Filenames must always be specified with a file suffix of: 


SS for Sequence files 
ort for Part files 
sPC for Piece files 


Filenames may be any valid Fairlight-type name ( 8 characters 
maximum, first character must be alphabetic). 


Commands are: 


2.1 LCAD, [filename] 
or L,{filenare] 


Load a file from disc into memory. 

The contents of a file may be used to invoke loading of 
further files by enclosing the filename in ( ) e.g. 
LOAD (PART.PT) will load the part file PART, then read the 
file to see which sequences are called for by that part. These 
are in turn loaded. 

LOAD ((FIECE.PC)) will load the piece, then the part, 
then the seauences within the parts. 

If no filename is specified, the LOAD command defaults to 
the lest name specified for a LOAD. 


The letter L on its own can be used in place of the word 
LOAD for convenience. 


Dee oa | 
or P{,k],(filename,filename,filename,... ] 


. Play all files specified simultaneously. The files may be 
a mixture of PART and SEQUENCE files. ([k is an optional 
Keyboard Number. The files specified will, be assigned to 
successive keyboards starting with keyboard ke af specified. 
If ne “k” is specified, the first file will be assigned to 
keyboard one, the next to key board two, and so on. 
Alternatively, a single PIECE filename may be specified. 
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The letter P on its own may be used instead of the word 
PLAT. 

If no filenames are specified with the PLAY command, the 
names used for the last PLAY will be used. If it is the first 
time a PLAY has been specified since system start-up, or since 
the last RESET command, then the last filename loaded will be 
assumed. If no file has been loaded since the last RESET then 
the last file edited will be played. 


mo abort a PLAY, type <cntrl ESC>. 


EDIT, [filename] 
or E, (filenare] 

Edit a file. Filename must be a currently loaded file 
Whenever the editor opens a file for editing it is first 
checked to ensure that it is a valid M.C.L. file. This means 
that it must contain correctly formatted sequential line 
numbers, all lines must be less than 80 characters long and it 
must end with a <earriage return>. Any file which does not 
meet these criteria will be rejected and the message: ‘BAD 
FILE, CANNOT EDIT will be displayed. 

Refer to Section 3 for details of Editor commands. 


NEW,<filenarmei>[,filename2] 


Create a new M.C.L. file. The file will be created in 
memory, but no disk allocation is made. <filename> must not 
already be loaded into memory 

If filename2 is specified, the file .created will be 
initialised to be a copy of filename2. 


SAVE,<filenarme> 


Save a file to disc. If the file specified is already on 
the disk it will be overwritten. The same format as load is 


allowed, i.e. SAVE ((filename.PC)) will save the piece, parts 
and seeuences. 


CLIAR,<filename> 


Kkemove the file specified from memory. This makes the 
memory and directory space occupied by that file free but it 
TOES NOT save the file to disc before clearing it. 


CLEAR,* may be used to clear all files. It also clears 
the default FLAY and EDIT filenames. 


TIR 


Display list of filenames currently loaded. If <spaceDdAa 
is specified after the LTIR command, the SIZE of each file (in 
tytes) will be displayed next to its name. 
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3.8 Q 


This is the QUERY command, which displays the state of 
various system variables, i.e.: 


SPEED, SYNC, CLICK, xX, TIME, WAIT, WARN, PROMPT, and FREE 
(memory unused). 


5.9 RESET 


Reset the values of all system variables (see above under 
Q command) to their defaults. These are as follows: 


SPEED. 1480 ; 
SYNC INT (EXT division ratio set to 1) 


CLICK OFF 48,4 
x OFF 
TIME OFF 
WAIT OFF 
WARN OFF 
PROMPT OFF 


3.18 SPFED=<number> 
or S=<number> 


Set replay clock speed in microseconds per tick. 
{.e. SPEED=17020 means 1% ms. / tick at which speed 
using B=24 a note of time-value i will last 248 ms. 

The default speed on system start-up is 10000. 

The permissible range of values for the SPEED command is 
1228 to 689¢2. 

The letter S on its own can be used instead of the word 
SPIEL. 


3.11 SYNC=INT or EXT or number 
Select the M.C.L. replay synchronisation mode. 


INT means use internal speed setting. 
EXT means use SYNC INPUT pulses as clock. Two sync 
pulses = one clock tick ( B unit) 

number Means use external sync divided by the number. 


The permissible range of values for external sync is 
1 to 68202. 
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3.12 CLICK=<¢rate>[, intro] 


Means generate a click track from the sync output and/or 
monitor amplifier. Rate is specified in BEAT units, and 
Intro is the number of clicks to be issued before the 
Playing starts. The CLICK volume heard in the monitor speaker 
can be adjusted using the SYNC MONITOR control on the rear 
panel of the Fairlight. 
The range of values allowed for rate and intro is @ to 
255. If no value is given for intro then the number 4 will be 
assumed. 


CLICK=CN and CLICK=OFF can be used to turn the CLICK 
function on and off. 


3.13 PRINT,filename 


Print the file specified on the line printer. The SHARP, 
FLAT and NATURAL symbols will be printed as s, f, and n. The 
same format as the LOAD command can be used to Print parts and 
sequences autcmatically, i.e. PRINT ((filename.PC)) will print 
the PIECE, PARTS and SEQUENCES. 


3.14 COM 


The COM (COMPILE) command has been provided to enable 
M.C.L. pieces to be converted to sequencer files so they can 
be replayed or merged on PAGE 9. The format of the COMPILE 
command is as follows: 


COM[,output filename][,keyboard] [input filename(s)] 

All the parameters are identical to the PLAY command 
except for <output filename>. This is the sequence file which 
is to be created and must have the suffix .SQ or no suffix at 
all. 

If the output file already exists then you will be asked 
whether you want to overwrite the existing file. Any response 
other than Y<cr> will terminate the compile command. 

If a COMPILE has already been done then the = previous 
output filename will be assumed if none is specified. The 
input filename can be any M.C.L. file or list of up to eight 
sequence files and part files. If no input filename(s) are 
specified then the same default name as would have been used 
by the PLAY command will be taken. If an input filename is 
specified then the default PLAY filename will be changed to 
the name specified in the COM command. If tke keyboard number 
is to be specified but no output filename then only one comma 
should te used tetween COM and the number. 
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3.15 WAIT=ON or OFF 


Turn the WAIT function on or off (see section 2.24) 


3.16 X=ON or OFF 


Turn the X function on or off (see section 4.4) 


3.17 TIME=ON or OFF 


Turn the TIME function on or off (see section 4.2) 
3.18 PROMPT=ON or OFF 


Turn the PROMPT function on or off (see section 2.2.6) 
3.1 WARN=ON or OFF 


Turn the WARNING on or off (see section 4.1) 
3.26 SYSTEM QUERIES 


To find out the current settings for SPEED, SYNC, CLICK, 
TIME, WAIT PROMPT and X type in the name of the variable 
followed immediately by a carriage return. The system will 
respond by displaying the current value on the graphics 
screen. 


** M.C.L. —- APRIL 1981 ** Page 21 


SECTION Z - M.C.L. COMMANDS (CONTINUED) 


e.en DIY 


Calculate the number of beats corresponding to a certain 
number of clock ticks at a given B value. The command format 
is: 


DIV,<ticks>,<B value> 
The output produced is as follows: 
<rnur>/<denom> OR <quot> + <rem>/<denom> 


Where <num> and <denom> are the improper fraction 
corresponding to the required number of beats (ie same as 
<ticks>/<B value> but reduced to lowest terms), <auot> is the 
integer quotient of <num> and <denom>, and <rem> is the 
remainder. 

This command is intended for converting the numbers of 
clock ticks output by the TIME (7) function. 

For example, assume that a ? request informs you that at 
a certain point in a sequence 1980 clock ticks have elapsed. 
You want to synchronise a second seeuence so that it starts 
playing at this point; the second sequence has a B value of 


36. 

Eow many rests are required? 

Use the LIV command as follows: 
DIV ,12@2@ ,36 


The following output will result: 
258/92 OR 27 + 7/9 
Thus you can either use R,258/9 or R,27:R,7/9 to produce the 
required delay. It is generally preferable to use the second 


format as the first method stands a greater chance of 
producing an arithmetic overflow. 
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SECTION 4 — DEBUGGING AIDS 
4.1 RUN-TIME ERRORS AND WARNINGS 


At Run-time (that is when the PLAY command is executed) the 
Composer syster starts interpreting the PIECES, PARTS or SEQUENCES 
and executing the performance according to the data it encounters. 
At this time various types of invalid data may be detected, and 
agpropriate messages will appear on the screen. 

The M.C.L. differentiates between two levels of severity of 
such problems by classifying them as WARNINGS or ERRORS. 


Warning messages are given for some common limiting 
conditions. These are: 


a) Octave value out of range (not in range 1-7) 

b) Velocity value out of range (not in range @ to 15) 

c) Gap time (or Hold time) of zero 

d) Gas time (or Hold time) longer than the note 

e) Control value (see above) out of range (not in range 8-127) 

When an out-of-range condition occurs the value will be 
forced to the limiting value which was exceeded. In the case of 
gap and hold time, if the value calculated is zero then a value of 
1 clock tick will be used. If the value is greater than or equal 
to the note time then a value of note time minus 1 clock tick will 
be used. Warning messages are displayed in the same format as 
error messages but the associated part will not be terminated and 
Playing will continue as normal. However if the warning appears 
very near the start of a play there may be a delay (and some 
lost clock ticks) because the message requires a disk access to de 
made. When the system is first loaded warning messages are 
disebdled (i.e. the limiting condition is handled as above, but no 
message appears and no time will be lost by disk access); to 
enable messages for detugging the command WARN ON (or WARN=ON) 
should be given. After a piece is debugged then the warning 
messages can be disabled by the command WARN OFF (or WARN=OFF). 


FFRORS result from : 


a) PARTS or FIFCES reeuesting files that are not loaded. 

b) Syntax errors in the files. 

c) Any characters in a file which is M.C.L. does not 
recognise. 


When an ERROR is detected, the PART concerned will stop 
playing, whereas after a WARNING it will continue. 

All messages are accompanied by the nare of the file in which 
the error occurred. The offending line and its line number will be 
disvlayed, and an upward arrow will be displayed underneath the 
first character in the line which seemed to be responsible for the 
error. In some cases this will point exactly to the error, in 
other cases it will cnly provide a clue. 
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Note that the interpretation of composer files is always some time 
ahead of the music you hear, so that error messages will usually 


appear on the screen before the music being played reaches that 
point. 


If, after a piece has finished playing, the message 
"WARNING: CLOCK TICKS LOST = nnnnn™ 


appears, this indicates that the speed at which the music was 
Played was so high that the composer system was not able to 
interpret the files fast enough to keep up with the rate at which 
the music was being played. nnnnn indicates how many B units were 
spent waiting for the composer to catch up. This condition should 
never occur.in normal operation, but may appear if the X function 
is used to turn off the music in the middle of a pierce or if a lot 
of WARNING messages were being generated. 


4.2 TIME FUNCTION 


When creating a piece of music using the composer it is often 
necessary to calculate the number of beats up to a certain point 
in the music, or between two points, in order to synchronise with 
another part. : 

The TIME function (in conjunction with the X function 
described below) can be used to ease this problem. By inserting a 
question mark at a certain point in any sequence file, the 
computer will, when it reaches the question mark during a PLAY 
command, display the following data: 


FILE = <sea>/<part>/<kbd> TIME = <time1l>/<time2> 
line of sequence containing the ? > 


7 


<pointer to exact position of the ?> 


Where: <see> is the name of the sequence 
<part> is the name of the part playing the sequence 
<kbd> is the keyboard number being played 
<timei> is the time since the last ? 
<time2> is the time since the start 


As an example, the number of rests needed to make a new sequence 
come in at a particular point is obtained by dividing the number 
of clock ticks up to that point (as shown by the TIME function) by 
the value of B. 

The DIV command can be used to calculate correct durations 
from given Time and Beat values (see section 3.21). 
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4.3 HALT AND SINGLE-STEP 


It is possible to interrupt a piece of music at any time dy 
Fressing the CONTROL-W key (ie press the W key while holding the 
CTRL key down). This will have exactly the same effect as if a 
WAIT command (W) had been encountered in the piece being played, 
except that it will function regardless of whether the WAIT 
feature is enabled or not. To resume playing press any key on the 
keyboard. It 1S suggested that a non-printing key (such as HOME,. 
CLEAR, ESC or an arrow) is used so that it does not appear when 
the piece is finished. 

The single step feature iS an extension of this. If the music 
is halted (by the CTRLI-W key or the WAIT function) and then the 
CTRL-¥ key is pressed to restart the playing, the system will 
advance to the next time unit (ie a key depression or release) and 
then stop again. This process can be continued indefinitely. Note 
that since, in general, each note that you hear is two time units 


(a depression and a release), the system will play one note or 
chord for each two CTRL-Ws. 
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4.4 "X" FUNCTION 


This function enables the user to selectively omit certain 
parts of a piece when the PLAY command is used, while still 
keeping all parts in correct synchronisation with each other. 

By inserting the character X in a sequence file, followed by 
a plus (+) cr minus (-) sign the user can turn the actual playing 
of the piece on and off. The character string "X-" will turn the 
music off, while “X+" will turn it tack on. Note that the 
COMPOSER still has to read all of the music, in order to keep 
track of default values, timing etc, but no music will be played. 
Because of this, there may be a delay of a few seconds (or even a 
minute if it is a very long piece) before the music resumes, while 
the Comroser skifrs through the files looking for the next X+. 

Redundant X+ and X-“s (eg X- when the music is already off) 
will be ignored. This feature is especially useful when the 
musician is working on the end of a long piece, as it enables him 
to miss out the parts which have already been corrected, and just 
listen to the part he is working on. 

Both the xX and the ? features can be used in PART files by 
making use of the QUOTE feature ("). (see under PART files). Thus 
to listen to the last sequence only in a part, and to find out how 
many ticks into the piece it starts, the following construct may 
be used in the PART file: 


* TURN THE MUSIC OFF 
X- 
SEQ1.SS 
SEQ2.SS 
SEO3.SS 
* NOW TURN IT EACK ON AND FIND OUT HOW 
* MANY TICKS HAVE ELAPSED 
ae 
SEQ4.55 
END 


When the X and TIME functions are disabled by the respective =OFF 
commands they are ignored by the composer and may be left in the 
files if desired. 
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SECTION 5.=— M.C.Ls EDITOR 


5.1 USING TEE EDITOR 


The EDITOR is used to create or modify M.C.L. files. It 
includes many fowerful features to enable rapid text generation 
with a minimum of typing effort. 

The editor is invoked by means of commands entered after the 
M.C.L. prompt appears on Page C. Fer example, tc create a new 
Sequence file called SOLO , enter the command: 


NEW,SOLO.SS 


Remember, all M.C.L. commands (but not all EDITOR commands) 
must be terminated by the RETURN key <RTIN>D. 

The screen will then change its format, and you will de 
presented with an almost empty display. The second line from ‘the 
top of the screen will eche whatever characters you type. Nothing 
else will happen until you issue an EDITOR command. To do this, it 
is necessary to indicate that you have finished entering the text 
data and you want the Fditor to perform some action, such as 
inserting the line of text into a file. ee a ; ; 

For this purpose certain control characters are used as 
commands. A control character is not printable, so it can not be 
confused with part of the text. The functions of the various 
control characters is described in detail in the remainder of 
section 5. 

As text is inserted into the file, it appears at the middle 
line of the screen, and line numbers are automatically generated 
for reference purposes. 

When the Fditing is complete, the command <E ESC> is used to 
itch Ue to the M.C.L. system (i.e. type an EF followed by the ESC 
key). 


7 The command “NEW is used to create a new file, the command 
EDIT is used to modify an existing file. The file to be edited 
has to be loaded from disk before the EDIT command is given. 
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5.2 COMMAND FORMAT 


Note: In the following descriptions, the word “string means 
any group of alpha-numeric charecters, which may include spaces. 
The < xxx > notation is used to indicate a Special control key. 


Commands take two general formats. The first consists of a 
String terminated by a@ control character which defires the 
commands the second consists of a string containing a command 
letter and terminated by the control char <esc>. 

Commands of the first type are: 


<home>,<up arrow>,<down arrow>,<left arrow> 
<right arrow>,<RIN>,<add>,<sub> 


Commands of the second type are: 


M,i,5,0,P,F.0,\,.R 8,3, 0,0 ,E 


Commands of the first type have no fixed format, the other 
commands all have the structure: 
<number(s)><command letter><string(s)><esc> Multiple numbers must 
be separated by commas. 


If any optional numbers or strings are not supplied, default 
values will be assumed. Those commands which do not require 
strings will give a syntax error if the commend alata is not the 
last character in the input lize. 


For some commands the string must be a valid filename. 
Filenames must always have a valid M.C.L. file suffix: 
sS8y aff OF «PC s 


Numbers or filenames may have any number of spaces on either 
side, and type 2 commands always ignore any leading spaces. 
Numbers may in almost every case be replaced by the special 
character & which is considered to have a value of 1@,@@9. All 
numbers must be four decimal digits or less, and may te preceeded 
by a plus or minus sign. 
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5.3 FILE FORMAT 


M.C.L. files have line numbers attached to every line. The 
line number is an integral part of the line and cannot be deleted 
unless the whole line is deleted. 


Line numbers are in the range of ABPY to 9OSS and must de 
sequential; although the editor will allow adjacent lines to have 
the same number they may not decrease in value. 


If a line is created which has the same number as the one 
before or after then the warning message ‘Line Number Conflict 
will be given and it is recommended that the resequence command 
be used to remove the conflict befcre ending the edit. This will 
avoid confusion later as line numbers are assigned automatically 
by the editor when a line is inserted. 


The maximum length of any line created by the editor cannot 
exceed 79 characters (not including line number). 


5.4 CURSOR POSITIONING 


While editing a file the currert character position (cursor) 
being edited is defined by: 


1) the current line and 
2) the character position within the current lire. 


Initially the cursor will be at the home position (beginning) 
of the first line of the file. 


When at the home position the cursor is pointing at the line 
number and this is indicated by the line number being displayed as 
black-on-white on the screen. In this position lines of text can 


be inserted sequentially into the file in front of the .current 
line. 


When the cursor is moved out of the home position by use of 
the right or left arrow commands, or by a character string search 
or change command, then the character being referenced is 
indicated by a break in the window surrounding the current line 
either side of the character. The actual point of edit is 
immediately to the left of this character. 


When the cursor is not at the home position then the line 
oriented commands (RETURN,L-SUB, 2,W,S) will behave differently. 
The cursor can be moved back to the home position at any time by 
use of the HOME command. 


If the cursor is moved to the end of the file then the 
current line will be empty (ie no line number and no tert). When 
text is added a new line number will automatically be assigned. 
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5.5 INPUT LINE 


Characters are entered into the command line and are not 
processed until a control character is received. There are two 
special control characters which operate only on the command line. 
These are <clear> and <cntrl B>. 


The CLEAR command will erase the current command line as on 
any other page of the Fairlight. 


The <control-B> command, which will be referred to as 
PESTCRE, causes the command line to be reset to it’s condition at 
the time of the last editor command. 


Every time a command is executed the command line is saved. 
(there are some exceptions to this.... see below) If the RESTORE 
command is issued, characters which have been typed in since the 
last command will overwrite the previous contents of the command 
line, but the rest of the command is not changed. This feature is 
very useful if, for example, an error was made right at the start 
of acommand. The first part of the line can be retyped, and then 
<centrl B> is hit to RESTORE the rest of the line, saving a lot of 
typing. 


The command line is cleared after each command has finished 
execution except for the following cases: 


a) after an error condition occurs 
bd) the command was a simple cursor movement 


RESTORE can not be used following commands: 
D<esc>, <esc>, <home>, <sub>, all arrow commands. 


5.6 ERROR MESSAGES 


Error messages are printed on the top line cf the screen and 
are cleared as soon as the next input character is received 
(unless its <clear>, which only clears the input line) 


If an error occurs due to dad syntax of the command line (ie. 
a typing error or other mistake by the user) then the command will 
not be executed at all. If the error occurs for some other reason 
then the command may or may not be executed, or only partially 
executed, depending on the nature of the error. 


For rultiple repetition commands the message “warning and 

"count=nnnon may appear, indicating that the number of repeats 

reauested could not be executed. In this case nmnnn represents the 
number of repetitions that were actually made. 
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5.7 COMMAND DESCRIPTION 


5.7.@ HOME (RESET CURSOR) 


<home> 


Move the cursor to the home position. If already there then 
do nothing. The input line is not affected and may contain 
anything. There are no error conditions for this command. 


5.7.1 ARROWS (MOVE CURSOR) 


<right,left arrow> 


Move the cursor right or left. If at home then left arrow 


has no effect, if already at end of line then right arrow has no 
effect. : 


<up arrow> 


Move cursor up (ie towards start of file). Thus the text on 
the screen will ‘scroll downwards. 


<down arrow> 


Move cursor down (ie towards end of file). Text will scroll 
up on screen. The cursor may move past the last line, which is 
known as the end-of-file position. As this line is completely 


empty no line number will appear until something is inserted into 
the line. 


For the up and down arrow commands the cursor will attempt to 
remain at the same character position in the new line; however if 
the new line is not long enough then the cursor will be positioned 
at the end of the new line. For the multiple line moves (see 
below), the cursor position is not affected by the lengths of 
{intervening lines, only the starting and final lines. 


All of the four arrow commands may be preceded by a 
repetition number providing that it is the only thing in the input 
line. The infinity character (&) can also be used. However if 
there is more than a single number, or extra characters in the 
input line then the arrow commands will always take a default 
value of 1. The same applies if an invalid number is found (ie 
too many digits). The input line is always unchanged by cursor 
moving commands. 
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TEXT INSERTION AND DELETICN COMMANDS 


5.7.2 RETURN (INSERT LINE) 
<string><carriage return> 


This command inserts a line of text into the file at the 
current cursor position. If the cursor is at home then the new 
line goes before the current line and is assigned a line number 
equal to the number of the preceding line (or @ if there isn’t 
one) plus 1 However if this would be greater then or equal to the 
current line number then the number assigned will te one less than 
the current line number. 


If the cursor is not at home then the new text will de 
appended to the left hand part of the current line, and the right 
hand part will become a new line. 


The line number assigned will be the current line number plus 
1 or the following line number minus 1, whichever is the smaller. 


Errors may result if the line nvumbers are already in 
conflict, otherwise only a warning will be given. Errors will 
also occur if the editor workspace is not large enough or the 
resulting line would be too long. 


The cursor is always repositioned at the end of the inserted 
text; thus if the cursor was at home, it will remain at home, 
otherwise it will be repositioned immediately after the new line 
number. 
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5.7.3 L-SUB (DELETE LINES) 


€<n>,L<sub> 


Delete <n> lines starting from current cursor position. If 
<n> is omitted then the comma must also be omitted and a value of 
1 is assumed. . 

If -cursor is at home then the current line is deleted and the 
following line tecomes the new current line. This process is 
repeated <n> times or until the end of the file is reached. 


If the cursor is not at home then the right part of the 
current line is deleted, the following line number is removed and 
the following line joined to the left part of the current line, 
provided that this does not result in too long a line. If this is 
the case then an error is given and nothing is deleted. The'new 
line becomes the new current line. 


It will be seen that the L<subd> command will reverse a <CR> 


(insert text) command if the cursor is repositioned to the start 
of the text that was inserted. 


The not-at-home <n>,L<subd> command will repeat <n> times or 
until the end of file, or until a deletion can not be done due to 
@ line being too long. 


‘If the number specified is preceded by a “-" sign then lines 
will tbe deleted backwards from the current cursor position. Thus 
if the cursor is at home then -L<sub> will delete the previous 
line. 


If the cursor is not at home then the left hand part of the 
current line and the current line number will be deleted,and the 
right part of the current line will be concatenated to the 
previous line, provided that the resulting line is not too long. 


The cursor remains at the same position after a delete line 
operation. 
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5.7.4 ADD (INSERT STRING) 


<string><add> 


Insert <string> before current character position. Line 
length must not be exceeded. 


5.7.5 SET (OVERWRITE STRING) 


<string><set> 


Overwrite characters in the current line starting at current 
character. If <string> is longer than the right part of the 
currert line then tke line will be extended, provided that this 
does not cause the line to exceed 2S characters. 


If an <add> or a <set> command is executed while the cursor 
is at the end-of-file position then a new line number will de 
assigned (provided that there is sufficient buffer space) before 
the command is executed. 


5.7.6 SUB (DELETE CHARACTERS) 


<n><sud> 


Delete <n> chars starting at current character position. 
cursor remains at the same positicn. This is a character command 
and will not delete lines. Thus &<sub> will delete the rest of 
the current line. If n is omitted a value of 1 is assumed. 


If the number specified is negative then characters. will be 
deleted backwards starting with the previous character. (the line 
number will not be deleted) 


All three of the preceeding commands will autcmatically move 
the cursor out of the home position if necessary before execution. 
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5.7.7 M (MUSIC KEYBOARD INPUT) 


<+ or ->M<sharp or flat><default octave ><esc> 


This command controls the inputting of characters from the 
music keyboard. On initial entry to the editor the music keyboard 
is disabled. After the M command is given, Switch 1 on the 
music keyboard will turn the music keyboard inputting cn and off. 
Wher turned On, key depressions on the music keyboard will’ cause 
the M.C.L. representation of the note to be inserted into the 
file being edited at the current cursor position. The exact format 
of the note generatedis determined by options specified on the M 
command, but is in the general format 


:<note name><accidental (if any)><octave(if any)> 


Note that no timing information is taken from the notes 
entered on the music keyboard. 


Commard format: 


If a sharp or flet character follows immediately after the 
letter M then all accidentals will be written using that 
character. Thus you can select whether to write Bflat or Asharp. 
If no hg ee is specified then the previous selection will 
remain, “flat” if there has been no previous selection. 


After the accidental, if any, a default octave may de 
specified in the form “O=<number>", where number must be from @ to 
7. If @ then the default octave feature will be turned off and all 
octave values written in absolute form. Any other value will set 
the default octave and the octave value for keystrokes will be 


written as a relative value. This will facilitate later 
transposition if desired. 


Examples of M command: 


+M<esc> enable keyboard inputting. Attach the octave number to 
each rote. 


+M<Ccntrl F>O=4<esc> enable keyborad inputting. Use flats, make all 
octaves relative to octave 4. 


As well as the above, switch number 2 on the music keyboard 
is designated as the chord switch to make entry of chords 
easier. When switch 2 is pressed ar open bracket ( is written 
into the input line, and when it is released a close bracket 
is put into the file. Thus all keystrokes entered while the switch 
is depressed will be considered by the M.C.L. editor as a chord. 
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To turn the keyboard off the command “-M<esc>” must de given. 
The keyboard can be temporarily turned off ty releasing switch 1, 
or pressing and releasing if it is already up. The next depression 
will then turn the keyboerd back on. 


If the cursor is at the start of a line or if the input line 
already contains some user inserted characters then the colon (:) 
will te omitted. 
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5.7.8 L (LOCATE LINE NUMBER) 


<n>L<ese> 


Locate line number <n> or the next higher line number <n> 
defaults to @99@. Thus L<esc> will go to the start of the file 
and &lI<esc> will go to the end of the file. 5.7.9 S (RESEQUENCE 
LINE NUMBERS ) 


<ni>,<n2>S<esc> 


Resequence line numbers. This command is used to make room 
in the line numbers for more lines to be inserted. For this 
reascn it works differently depending on whether the cursor is at 
home. If it is, then resequencing starts with the current line 


because new lines will be inserted before it. Otherwise 


resequencing Starts with the following line. 


<ni> is the increment to be applied between successive 
line numbers, and defaults to 1% <n2> is the starting value, 
which must not conflict with the previous line number (or current 
line number if not at home). If <n2> is not specified then it 
defaults tec the previous line number ( or current line number) 
plus the increment. 


The maximum line number is 9SS¢S and a warning will be given 
if this value is reached before end cf file. If <n1> is omitted, 
then the comma may also te omitted. 
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TYPE TWO COMMANIS (continued) 
5.7.10 D (DISPLAY TEXT) 


€n>D<escd: 


Display <n> lines on the Screen starting at current line. 
after a display the screen will not be showing the current cursor 
position. to avoid silly mistakes the editor will not accept any 
cursor dependent commands but will give the message NO LINE 
OFEN . To reopen the current line the command char <esc> rust de 
typed or its own, after which the screen will te rewritten at the 
correct position. 


If a negative number is specified befcre the [T command then 


the display command will scroll downwards towards the start of the 
file. 


5.7.11 P (PRINT TEXT ON LINE PRINTER) 


<r>P<esc> 


Print <n> lines on the line printer. The name of the 
currently open file is printed at the start of a listing and at 
the tor of each page. Alternative forms of the print command are: 


P/<esc> which will cause the printer tc eject one page. 


P:<text><esc> will print <text> on the line printer at 
the current page position then advance to the next line. Thus 
P:<esc> will skip 1 line. 


If the printer is not connected or not eeally (power off) when 
the P command is given, the error message’ “PRINTER NOT REALY will 
be displayed and the command aborted. 


Both the display and print commands may be temporarily halted 
by pressing <control>¥ (for Wait), and resumed by pressing 
C€control>W again. Alternatively the command may te aborted 
altogether by pressing <control><esc> (known as BREAK). 
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5.7.12 F (FIND STRING) 


<rn>F<string><esc> 


Search file from current position for <n> occurrences of the 
string <string>. Each time the string is found the cursor is 
repositioned to the START of the string, and it will not be moved 
until another instance is found. <n> defaults to 1. <string> 
must have at least ore character. 


£.7.12 C (CHANGE STRING) 


<n>C<stringi>\<string2><esc> 


Search rest of file from current position and change <n> 
instances of <string1> to <string2>. each time a string is 
changed the curscr is repositioned to the start of the string. 
<n> defaults to 1. <stringi> must, have at least 1 char. 
<string2> may be null. The delimiter’ “\” MUST occur exactly once 
the the command line. 


The backslash character (\) is obtained by typing <shift>L on 
the Fairlight’s alphanumeric keyboard. 


5.7.14 \ (CHANGE PREVIOUSLY FOUND STRING) 


\<string><esc> 


This command enables a previously found or changed string to 
te changed again without retyping it. Whenever a string is found 
by the F or C commands its position and length are saved (until 
the cursor is moved again). This is referred to as the current 
string and it may de of any length including zero (after a CHANGE 
with rull string2) If there is no current string an error will 
result. 
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5.7.15 R (REAL TEXT INTO COPY BUFFER) 
<n>P<esc> 


Read <n> lines into the editor’s copy buffer. This buffer is 
separate from the normal workspace and is used to save pieces of 
text for later insertion into the same file or a different file. 
Thus it can be used for block editing of files. Its contents will 
remain intact even after exiting the editor provided that no other 
command overlay is loaded. 


The copy buffer can be opened for editing by the "B” command 


and the conrtents displayed, printed or changed, as for a complete 
Pe 


The read command reads from the current cursor position ‘for 
<n> lines, <n> defavlting to 1. If the cursor is not at home then 
the first line read in will consist of the current line number and 
the right part of the current line. Only whole lines are stored 
in the buffer. 


The size of the copy buffer is approximately 4K characters; 
if tke number of lines specified in the R command will not fit 
into the copy buffer then the error message ‘COPY BUFFER 100 
SMALE will be given, and NO TEXT will be moved, so the contents 
of the buffer will remein unchanged. 


£.7.16 YW (WRITE COPY BUFFER INTO FILE) 
<n>wW<esc> 


Write the contents of the copy buffer into the current file 
before cursor position <n> times. Only whole lines are inserted; 
thus if the cursor is not at home the current line will tbe split 


into two pieces before and after the inserted text. This is a 
line oriented command. 


Line numbers are assigned as for multiple <carriage return> 
commands, so if a corflict occurs the last inserted lines will all 
have the same number ard a resequence should be done. <n> 
defavlts te 1. 
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5.7.17 B (OPEN COPY BUFFER) 
B<esc> 


Open the copy buffer for editing. The current file will 
become inaccessible but its cursor position will remain intact. 
While the copy buffer is open it may be edited using all the 
commands available except of ccurse the FE and W commands. 


5.7.18 0 (OPEN OR REOPEN FILE) 
O<esc> 


Close the copy buffer and reopen the current file at its 
previous cursor position. If the buffer is not open then do 
nothing , 


O<filename><esc> 


Close the current file ard open <filenare>. If the copy 
buffer is open it will be closed first and the current file 
displayed to give a visual warning that what you were looking at 
wasn’t the current file. The filename must refer to a file which 
is currently loaded in memory. ‘¥henever a file is closed its name 
and cursor position is saved for use by the O- command. 


All file opening commands will close the copy buffer if 
neccessary tefore closing the current file. 


O-<esc> 
Oren previous file, providing that there has been one. The 


current file now becomes the previous file. After the file is 
orened the cursor will be positioned to its previous location. 
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5.7.19 N (CREATE NEW FILE) 
. NCfilenarei>,<filename2><esc> 


Close the current file and then create a new file called 
<filenamel>. This file must not te loaded already and cannot be 
the Sare rame as the current file. If <filenarezZ> is specified 
(optional) then the new file will be initialised with the contents 
of <filenare2>, which must te loaded as for the O commands. 


The second filename may be replaced by the special symbol- "=" 
which will then cause the new file to be initialized to the 
contents of the current file. 


5.7.20 E (EXIT FROM FDITOR) 
E<filenare><esecd: 


Fnd edit, close the current file and return to the M.C.L. 
cemmand interpreter. The message END OF EDIT will be displayed 
on the console. If <filenamre> is specified then the current file 
will be renamed before it is closed. <filename> must not be the 
name of a file currently loaded. If so then an error message will 
be displayed and the file will remain open. 


If the file currently being edited contains no text at all 
then the empty file will be deleted and will not appear in the 
directory. 
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AFPENDIX A -— EXAMPLE SECUENCE FILE 


THIS SEQUENCE FILE IS AN EXAMPLE OF MANY OF THE FEATURES OF 
TEE FAIRLIGHT MUSIC COMPOSITION LANGUAGE. 


( NOTE THAT THE SHARPS, FLATS AND NATURALS APPEAR AS 
s, f, and n WHEN PRINTED, ALTHOUGH THEY ARE 
DISPLAYED AS TEE CORRECT SYMBOLS 

ON TEE FAIRLIGHT C.R.T. GRAPHICS TERMINAL) 


St ot 2 SE HE HO at te tt 


DEFAULTS ASSUMED UPON STARTING TO PLAY AN MCL PIECE 
1P=48: 0=3: V=15: G=1/4: T=0° 

* REAT=48, OCTAVE=2, VELOCITY=15, GAP TIME=1/4, 

* TRANSPOSITION=2 (NONE) 

FeGsAsfB<ecsD sb: F2 


-* SCALE PLAYED, OCTAVE 2 FOR ALL EXCEPT ENIING NOTE. 


* DEFAULT IS SET BY AN "=" 
!P=32 

*FLAY A SCALE AT BEAT=32 
FeG:AsfB:C:D:E:FS 


* DEFAULT OCTAVE SETTING 

!0=2 

* PLAY A SCALE AT THIS OCTAVE 
F:GsA:sfB:C:D:E:F4 


* DEFAULT ACCIDENTAL .- 
* MULTIPLE DEFAULT ACCIDENTALS SPECIFY A KEY SIGNATURE. 
* EXAMPLE WOULD EK -- IfB:fE:fA 

IfB 

%* DELAY A SCALE WITH TEIS DEFAULT ACCIDENTAL SETTING 
F:C:AsE:C:DsE:F4 


* DEFAULT VELOCITY 

!1V=19 

*| PLAY A SCALE AT TBIS VILOCITY 
FeGsAsEsCsD:E:F4 


* TRANSPCSE NOTES UP 5 SEMI-TONES 
1T=5 

* PLAY A SCALE AT THIS TRANSFOSITION: 
F:GsAsBsC:D:E:F4 


* CHANGE “DEFAULT GAP TIME” FOR NOTES 
1G=2/2 
* DEFAULT TIME, 


* NOTE WILL PLAY FOR 1/3 OF THE BEAT, AND THEN RELEASE FOR 2/3. 
FsGeAsBsCsDsEsk4 


* CHANGE FROM "GAP TIME” DEFAULT TO "HOLD TIME” DEFAULT. 
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* OR FLAT (CONTROL F) BEFORE OR AFTER THE NOTE. 
* THIS OVERRIDES A DEFAULT ACCIDENTAL OR: KEY sade cine 
Fs:sG:An:Bn:Cn:Df:fk:Fs4 


* RELATIVE OCTAVE AND VELOCITY 

* PLACE A + OR - IN FRONT OF THE OCTAVE NUMEER, 

* OR THE VELOCITY NUMBER. 

EV +220f +27 +4 24-1 SB EC 4s sD—2y -3,2,1 88:3 + 

* NCTE THAT +1 AND -1 CAN BE WRITTEN WITHOUT THE 1. 


THEREFORE THE FORMAT OF A NOTE IS: 
(s/f/n)LETTER(s/f/n) (OCTAVE) (VELOCITY)(,TIME(,GAP TIME)) 


3b tt 


SEPARATORS ARE OPTIQNAL BETWEEN NOTES AND LEFAULT SETTINGS. 
THEY ARE : AND , 


A WORD OF CAUTION /WARNING : 

SINCE A ACCIDENTAL (s/f/n) MAY COME BEFORE OR AFTER A NCTE -- 
THE LINE “F sG” WILL BE TAKEN AS Fs G. 

THEREFCRE ,ALWAYS USE THE : . 

FGARCDEF+ 


Hat He it we 


* CHORDS CAN BE SPECIFIED — — 

* AS NOTES ENCLOSED INSIDE PARENTHESES “(" AND “) 

* THE TIMZ FOR A CHORD FOLLOWS THE RIGET (CLOSING) FAREZNTHESE. 
(C:E:G):(D:F+:A),2,1: (E:G+:B)V12,2,1 (FAC)2,1 

* BECAUSE IT IS SC OFTEN FOCRGOTTEN-- 

*{HZ ",” AFTER THE ) IS CPTIONAL, 

* UNLESS A VELOCITY IS SPECIFIED. 


* USE A CCNTROL TO VARY THE VIBRATO DEPTH. NOTE THAT FOR 

* THIS EXAMPLE TO WORK, CNTRLS MUST BE ASSIGNED TO VIBRATO 
= DEPTH ON PAGE 7. 

* THE SCALE WILL BE PLAYED FCUR TIMES, THE FIRST TIME WITH 
* NO VIBRATO, THIN WITH 14 UNITS MORE VIBRATO EACH REPBAT. 
C5=@ <F:G:A:BsCsl:sE:F+ C&=+1954 


* USE A SWITCH TC SELECTIVELY TURN PORTAMENTO CN AND OFF. 
* NOTE THAT FOR THIS EXAMPLE TO WORK, SWTCH3 MUST BE 

* ASSIGNED TO PORTAMENTO ON Rinse Fs 

S3=@ F:G:A SS=1 B:C S3=2 Di EsF+ 


END 


AFPENDIX A - EXAMPLE SEQUENCE FILE (CONTINUED) 


* OR FLAT (CONTROL F) BEFORE OR AFTER THE NOTE. 
* THIS CVERRIDES A DEFAULT ACCIDENTAL OR KEY SIGNATURE. 
Fs:sG:An:Bu:Cnu:Df:fk:Fs4 


* RELATIVE OCTAVE AND VELOCITY 

* PLACE A + OR - IN FRONT OF THE OCTAVE NUMEER, 

* OR THE VELOCITY NUMBER. 

BV 42:6 "+27 +4 sA-153B-—2C+0-* sD-2¥-3,2,1 53 s¥+ 

* NCTE THAT +1 AND -1 CAN BE WRITTEN WITHOUT THE 1. 


THEREFORE THE FORMAT OF A NOTE IS: 
(s/f/n)LETTER(s/f/n) (OCTAVE) (VELOCITY)(,TIME(,GAP TIME) ) 


3b tt 


SEPARATORS ARE OPTIQNAL BETWEEN NOTES AND DEFAULT SETTINGS. 
THEY ARE : AND? 
A WORD OF CAUTION /WARNING : 
SINCE A ACCITENTAL (s/f/n) MAY COME BEFORE OR AFTER A NCTE -- 
THE LINE “F sG” WILL BE TAKEN AS a G. 
THEREFCRE ,ALWAYS USE THE 3: . 
GAPCLTEF+ 


taf St Gt He 4b. He Ht 


* CHORDS CAN BE SPECIFIEL _ _ 

* AS NCTES ENCLOSED INSIDE FARENTHESES ( ANL. 

* THE TIME FOR A CHORD FOLLOWS THE RIGET (CLOSING) FARENTHESE. 
(C:E:G):(D:F +:A),2,1: (E:G+:B)V¥1Z,2,1 (FAC)2,1 

* BECAUSE IT IS SC OFTEN FCRGOTTEN-- 

einE » AFTER TRE ) IS CPTIONAL, 

* UNLESS A VELOCITY IS SPECIFIED. 


USE A CCNTROL TO VARY THE VIBRATO DEPTH. NOTE THAT FOR 
THIS EXAMPLE TO WORK, CNTRLS MUST BE ASSIGNED TO VIBRATO 
DEPTH ON PAGE 7. 

THE SCALE WILL BE PLAYED FOUR TIMES, THE FIRST TIME WITH 
* NO VIBRATO, THEN WITH 14 UNITS MORE VIBRATO EACH REPEAT. 
C5=2 <F:sGsAsBeC sl sEsF+ C&=+19>4 


2 tt it % 


* USE A SWITCH TC SELECTIVELY TURN PORTAMENTO ON AND OFF. 
* NOTE THAT FOR THIS EXAMPLE TO WORK, SWTCH3 MUST BE 

* ASSIGNED TO PORTAMENTO ON PAGE 7. 

S3=@ F:G:A SS=1 B:C SS=2 Di Es F+ 


FND 
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APPENDIX B -— A SIMPLE EXAMPLE 


Reproduced below is an exarple of the M.C.L. version of 
“Three Blind Mice. In this instance, three parts are specified 
which play the melody in canon using three different keyboards, 
and hence three different voices may be assigned to the parts. 


The steps involved in generating this M.C.L. piece might be: 


1) Set up PAGE Z with three different registers, each 


with ae different voice, and assign keyboards 1 to 3 to 
registers A to C resrectively. 


2) Select PAGE C to enter the M.C.L. sub-system, and use 
the FDITOR to create a seauence file. The command would be: 
NEW,MOUSE.SS. 


3) Once the edit has been ended (using the. E<eso> 
command), the message ; 
END OF EDIT will be displayed. The command PLAY MOUSE.SS will 
then play the sequence just created, and as no PART has deen 
specified so far, it will default to keyboard 1. ‘ 


4) Create the three parts desired, in this case 
MOUSEA.PT, MCUSEE.PT and MOUSEC.PT. In order to make the 
MOUSEB and MCUSEC parts wait the correct tire before starting, 
a sequence consisting of just rests is introduced into their 
FART files. Remember to start the line of sequence with a 

-or the M.C.L. will lceok for a Seacuence called B=24 


5) Now create the REST@.SS sequence. 


6) Create the PIECE, MICE.PC which is simply a list of 
the PARTS to be flayed. The order in which the parts are 
specified is of no consequence in this case as the keyboard 
number has been specified for each PART. Otherwise the order 
would dictate which part plays which keyboard. 


7) Play the PIFCE, usirg the command: PLAY ,MOUSE.PC 
Note ary mistakes in the music or error messages which may be 
displayed. 


8) If your C.M.I. is equipped with a Line Printer, you 
car list the piece for reference and as an aid to debugging. 
The commend: 

FRINT ((MICE.PC will give you a listing of the ‘PIECE, PARTS 
and SEQUENCES like the one below. 


¢) Use the editor to correct any mistakes. 
1@) Don’t forget to SAVE your work on disk once you are 


satisfied with it. Use the command: SAVE,((MOUSE.PC to Save 
the niece, parts, and sequences. 
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FAIRLIGHT COMPOSER - LEVEL 5.3 MICE.PC PAGE 1 
FILENAME = MICE -PC 
9¢@1 ™ THIS IS THE “THREE BLINI MICE PIECE. 
@Z22 MOUSFA 
283 MOUSEB 
0904 MOUSEC 
0225 END 
FILENAME = MCUSEA PT 
9201 IK=1 
2222 MOUSE 
6083 END 
FILENAME = MOUSE .SS 
G@21 * THIS IS THE CENTRAL SEQUENCE TO EE 
@@@2 * PLAYED BY ALL THREE PARTS IN CANON. 
AOS <. 
@224 !B=24:0=3 
@0G5 <E:D:C:kR>2 
ACG G+rF+,1/2:F+,1/2:E:R G+:F+,1/2:F+,1/2:F:R,2/3 
@325 * NOW FOR THE MIDDLE BIT 
0035 !0=+:B=8 
0045 <G:C,2:C:B:A:B:0,2:G6:G:R>3 F 
055 *THE LAST BAR 
0265 O=-:B=12 
O0?75 E:Ds:Cs:R 
0985 * NOW REPEAT THE WHOLE LOT THREE TIMES 
9295 >3 
9195 END 
FILENAME = MOUSEB  .PT 
0291 * SECOND PART OF THE ROUND. 
geez * PLAY ON KEYBOARD 2 
Q@@2 K=z 
004 * REST FOR 8 BEATS 
0225 “B=24:R,8 
286 MOUSE 
eee? END 
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i} 


FILENAME = MOUSEC -PT 

6010 * TBIRI PART OF THE ROUND. 
G92@ * PLAY ON KEYBOARD Z 

G04 IK=2 . 
¢95@ * NOW REST FOR 16 BEATS 
G60 “B=24:R,16 

@7G MCUSE 

980 END 


This is how the 
screen looks after 
entering Page C and 
issuing the command: 
NEW MCUSE.SS (to 
create a new 
sequence). AS Soon 
as RETURN is hit the 
editor will be 
invoked (see photos 
next page). 
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AFPENDIX BR —- A SIMPLE EXAMPLE (CONTINUEL) 


This is how the 
EDITOR looks. The 
second line from the 
top is where 
commends are 
ertered. The empty 
box towards tke 
middle of the Screen 
is where the new 
text is about to be 
inserted. The line 
numbers are 
eenerated 
automatically (the 
next line will te 
number Zé). 


In this photograph 
the cursor is 
positicred over a 
typing mistake (the 
,O, in BLOND). Arn 

I has been entered 
into the command 
line (second line 
from the top). If 
the SET key is now 
struck, the C will 
be replaced by an 

I 
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APPENDIX B -— A SIMPLE EXAMPLE (CONTINUED) 


Once editing has | 
teen ended (using | 
the E<esc> command) 
the screen is | 
cleared and the 
message: 

MICE.PC END OF ETLIT, 
is displayed. The | 
SAVE conrand. has yt 
then been used. The, 

(( before the 
filenare has caused; 
all the parts andj, 
seauences to te 
saved as well as the 
PIECE. 


The LCAL command has: 
been issued. The 
before the 

filename has caused | 
all the parts and 

sequences to be ; 
loaded as well. Notei 
that the "))” is 
optional. 
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APPENDIX C - EXTERNAL SYNCHRCNISATICK 


1)Conrect an atdio oscillatcr to the tave recorcer input 
associated with the track which is to carry the SYEHC tone. 
Any oscillater with e variatle freauency cutout in the range 
1¢2 te Seve Ez car ve used. The Shape cf the waveform is 
irrelevant. 


?)Connect the evrropriete output of the tere recerder to the SYNC 
input of the C.M.I. (Pin 2 of the SYNC cernector). This is a 
Singl-erded (untalanced) inrut, requiricz a rinirum level.of 1 
volt P-P for reliable operation. 


Z)The M.C.L. will play at the speed determined by the precise 
frequency of the SYNC tcene. To find out the correct freeuency, 
rut the tape reccrder into “pyypass’ mede so that the sig “nal 
from the oscillator will pass straight throush to the output 
(and herce to the C.M.I1. SYNC input). Then select external 
syre (using the commend: SYNC=EXT) ané play the M.C.L. piece. 
Adjusting the frequency of the oscillator will vary the replay 
steed of the M.C.L. Select a suitatle speed or range of 
speeds. 


4)Lay down the SYNC track. The M.C.L. will start playing as soon 
as the tone starts coming cof tape, sG make sure thet the start 
of the SYNC tone is clean and is prececed by a few seconds of 
silence. 

It is possible to vary the speed of the piece dynémically 
by varying the oscillator frequency while layire down the SYNC 
treck. For this rurpcse it is rnec¢seery to te playing the 
M.C.L. piece in exterral sync mode while laying ccwn the sync 
track. 

Let the SYNC treck run for a few seconds lenger than the 
Mitehe Bienes 


5)From now on, all M.C.L. playing will faithfully follow this SYNC 
track (unless SYNC=INT is re-selected). Lay down each group of 
M.C.L. parts on a seperate tape track, making sure that the 
PLAY is executed with SYNC=5XT. 
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APPENDIX C - EXTERNAL SYNCKRONISATION 


The C.M.I. is provided with a three pir CANKON connector. 


labelled SYNC. 


The function cf each rin is: 


rit i SIGNAL GROUKT 
FIN 2 EXTERNAL SYNC INPUT 
PIN g CLICK OUTPUT 


USING CLICX OUTFUT 


This is a pulse-type output which is used primarily for a 


beat reference fer live musician accompaniment. It is also useful 


for debugging purposes. 

The click cutput can te connected te ar avdio arplifier vie 
any single-ernced line-level input. The amplituce of the click is 
atout 1 volt P-P. Tre click cén also be heerd vie the C.M.I. 
monitcr speaxer output. The volure of the click is cerntrolled ty 
the SYNC MONITOE econtrel on the rear panel of the C.M.I. 

The relationship tetween the click outrut ané the beat rate 
of the M.C.L. viece is set ty the cemmand: 

ChIgk=r,i = 
where r is the number of clock ticks per click and i is the 
nurter cf clicks introduction that will te heard tefcre the piece 
Starts playing. Perause the relationship between clock ticks and 
the teat rete of the M.C.L. is set dy the B=n statement ina 
secuerce or part file, using the sare numter fcr B=n and CLICK=n 
will result in cone click per beat. For example, if the M.C.L. uses 
R=24, then CLICK=96,4 will result in one click per 4-beat tar and 
4 clicks (=4 bars) intre. 


SYNCHRONISING TC MULTI-TEHACK TAPE 


If the corplete M.C.L. viece reeuires'more than the allowatle 
maxirun of eight varts, multi-track tape can be usec te allow 
further parts to be laic down. In this case it is necessary to lay 
down a syre track On an unused track of the téefe sc that the 
M.C.L. can follow variaticrs in the tape speed for perfect 
synchronisation. The precedure is as follcws: 
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